home *** CD-ROM | disk | FTP | other *** search
/ Gigarom 4 / Mac Giga-ROM 4.0 - 1993.toast / FILES / EXT / P-T / ProgrammersKey / Programmer's Keys / Programmer's Key Docs < prev   
Encoding:
Text File  |  1988-06-02  |  4.3 KB  |  103 lines  |  [TEXT/ttxt]
  1.  
  2.  
  3. Enclosure: FILE  Programmer's Key
  4.  
  5. Programmer's Key 1.1B3 of 03/04/88
  6. ----------------------------------
  7.  
  8. Revision History
  9.  
  10. ;    Created:  07/23/87  PM - 1.0D1    first cut using VBL task to call Debugger
  11. ;    Modified: 07/24/87  PM - 1.0D4    changed to use AutoInt1 instead of VBL's (yay!)
  12. ;          07/26/87  PM - 1.0D5     changed key combinations (works better with TMON)
  13. ;          07/26/87  PM - 1.0D6    added FlashMenuBar to ShutDown
  14. ;          08/04/87  PM - 1.0B1    added BufPtr -> sp for _ShutDowns in TMON; its stack
  15. ;                           too small, changed key combinations again (for ICOM)
  16. ;          12/29/87  PM - 1.1B1    removed BufPtr -> sp (see above)
  17. ;                     added support for classic keyboards, changed key
  18. ;                     sequences again, revved for ShowINIT31
  19. ;          01/31/88  PM - 1.1B2    added oldAutoInt7 for dual-debugger hack
  20. ;                     fixed option key bug on Classic keyboards
  21. ;          03/04/88  PM - 1.1B3    ADB sense code changed to use HWCfgFlags since
  22. ;                     SysEnvirons doesn't tell all about ISO, etc.
  23.  
  24. Tester Notes
  25. ------------
  26. *** The keyboard combinations have changed again, see the chart below ***
  27. 1.1B1 now supports the classic keyboards.  Try it and see what I mean.
  28. The 'hot' key is also configurable.  Let me know if you care.
  29.  
  30. There is also a very sick hack in this version which allows the use of
  31. 2 debuggers.  An example: if you rename Programmer's Key such that it
  32. loads before TMON, then pressing option-power will invoke MacsBug or
  33. the ROM minidebugger while all the other keyboard combos will still get
  34. you into TMON.  This feature is still under construction and has many
  35. pitfalls.  For instance, what happens when you use breakpoints with
  36. both MacsBug and TMON installed?  Save all your files and try it.
  37.  
  38. General Info
  39. ------------
  40. Programmer's Key is a small INIT that allows the use of the 'power-on' key of an
  41. Apple Desktop Bus keyboard as a substitute for the Programmer's Switch.
  42. To install Programmer's Key, simply drag it into your System Folder and reboot.
  43. You may then use the following key combinations:
  44.  
  45. ;    Trap Signal = Power-Command-Option (applies to TMON only, else the same as Interrupt)
  46. ;    Interrupt   = Power-Command (for like real Programmer's Switch)
  47. ;    Interrupt2  = Power-Option (sick hack - see tester notes below)
  48. ;    Reset        = Power-Command-[Control or Tab] (like real Programmer's Switch)
  49. ;    Restart        = Power-Command-Shift (uses ShutDown Manager)
  50. ;    ShutDown    = Power-Command-Shift-Option (uses ShutDown Manager)
  51. ;
  52. ;    On Classic Mac keyboards, substitute the delete key for Power (yes, I use MPW too)
  53.  
  54. To temporarily disable Programmer's Key at boot time, hold down the mouse button
  55. or the shift key.  To permanently disable it, drag it out of the System
  56. Folder.
  57.  
  58. Programmer's Key will work with any debugger, including the microdebugger in the
  59. 128K+ ROMs.  The use of the ROM debugger is discouraged since it does not
  60. have any builtin mechanisms to guard against potential problems such as
  61. interrupting a VBL task or interrupting itself.  However, Programmer's Key is no
  62. more dangerous than the real programmer's switch.
  63.  
  64. Note:
  65.     If you experience any weird behavior with the ROM debugger, please let
  66.     me know.  I have tested Programmer's Key with the ROM debugger and have had
  67.     intermitant problems after using _ExitToShell.  I'm not certain Programmer's Key
  68.     is causing the problem.
  69.  
  70. Programmer's Key will not Restart or ShutDown if the file system is busy, so
  71. if it doesn't seem to be responding, keep on holding the keys down.
  72.  
  73. Note:
  74.     There is a problem with the ShutDown key combo; if _ShutDown is
  75.      called while the 'power-on' key is down (thereby causing an
  76.     immediate reboot), the keyboard will not function properly.
  77.     If this happens, you need to ShutDown, wait a few seconds and
  78.     power back up.  This appears to be hardware problem.
  79.     I haved added a menubar flash as well as a short pause to the
  80.     ShutDown key combination so there is a chance to release
  81.     the power key.
  82.  
  83. The code to display the icon at boot time is called ShowINIT and is in the
  84. public domain and available from me directly.  If you'd like to use it in your
  85. INIT, please drop me a note.
  86.  
  87. Bug reports and comments are should be directed to one of the
  88. addresses below.
  89.  
  90. Programmer's Key may be freely distributed for non-commercial purposes
  91. as long this text file is also included.  A license is required for
  92. commercial distribution.
  93.  
  94. Enjoy,
  95.  
  96. Paul Mercer
  97.  
  98. Delphi:    PAULMERCER
  99. AppleLink: MERCER1
  100. MCI:       SOL
  101.  
  102. P.O. Box 160165
  103. Cupertino, CA  96016-0165